TS 132 663 - V6.7.0 - Digital cellular telecommunications system (Phase 2+); Universal Mobile Telecommunications System (UMTS); Telecommunication management; Configuration Management (CM); Kernel CM Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA) Solution Set (SS) (3GPP TS 32.663 version 6.7.0 Release 6)

ETSITS132 663v6.7.o

(2006-03)

Technical Specification

Digital cellular telecommunications system (Phase 2+)
Universal Mobile Telecommunications System (UMTS)

Telecommunication management
Configuration Management (CM)
Kernel CM Integration Reference Point (IRP)
Common Object Request Broker Architecture (CORBA)

Solution Set (SS)
(3GPP TS 32.663 version 6.7.0 Release 6)

•25$

ES

®

GLOBAL SYSTEM FOR
MOBILE COMMUNICATIONS

3GPP TS 32.663 version 6.7.0 Release 6 1 ETSI TS 1 32 663 V6.7.0 (2006-03)

Reference

RTS/TSGS-0532663v670
Keywords

GSM, UMTS

ETSI

650 Route des Lucioles
F-06921 Sophia Antipolis Cedex - FRANCE

Tel. : +33 4 92 94 42 00 Fax: +33 4 93 65 47 1 6

Siret N ° 348 623 562 0001 7 - NAF 742 C
Association a but non lucratif enregistree a la
Sous-Prefecture de Grasse (06) N° 7803/88

Important notice

Individual copies of the present document can be downloaded from:
http://www.etsi.org

The present document may be made available in more than one electronic version or in print. In any case of existing or

perceived difference in contents between such versions, the reference version is the Portable Document Format (PDF).

In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive

within ETSI Secretariat.

Users of the present document should be aware that the document may be subject to revision or change of status.

Information on the current status of this and other ETSI documents is available at

http://portal.etsi.org/tb/status/status.asp

If you find errors in the present document, please send your comment to one of the following services:

http://portal.etsi.org/chaircor/ETSI support.asp

Copyright Notification

No part may be reproduced except as authorized by written permission.
The copyright and the foregoing restriction extend to reproduction in all media.

© European Telecommunications Standards Institute 2006.
All rights reserved.

DECT™, PLUGTESTS™ and UMTS™ are Trade Marks of ETSI registered for the benefit of its Members.
TIPHON™ and the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members.
3GPP™ is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 2 ETSI TS 1 32 663 V6.7.0 (2006-03)

Intellectual Property Rights

IPRs essential or potentially essential to the present document may have been declared to ETSI. The information
pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and can be found
in ETSI SR 000 314: "Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in
respect of ETSI standards", which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web
server ( http://webapp.etsi.org/IPR/home.asp ).

Pursuant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee
can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web
server) which are, or may be, or may become, essential to the present document.

Foreword

This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP).

The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or
GSM identities. These should be interpreted as being references to the corresponding ETSI deliverables.

The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under
http ://webapp . etsi.org/kev/queryform. asp .

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 3 ETSI TS 1 32 663 V6.7.0 (2006-03)

Contents

Intellectual Property Rights 2

Foreword 2

Foreword 4

Introduction 4

1 Scope 5

2 References 5

3 Definitions and abbreviations 6

3.1 Definitions 6

3.2 Abbreviations 6

4 Void 6

5 Architectural features 6

5.1 Notifications 6

5.2 Filter language 6

5.3 Syntax for Distinguished Names and Versions 6

6 Mapping 7

6.1 Void 7

6.2 Operation and Notification mapping 7

6.3 Operation parameter mapping 7

6.4 Notification attribute mapping 8

7 Use of OMG Structured Event 10

8 Rules for NRM extensions 13

8.1 Void 13

8.2 Extensions not allowed 13

Annex A (normative): IDL specification (file name "KernelCmConstDefs.idI") 14

Annex B (normative): IDL specification (file name "KernelCmlRPSystem.idl") 16

Annex C (normative): IDL specification (file name "KernelCmNotifications.idl") 17

Annex D (informative): Change history 20

History 21

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 4 ETSI TS 1 32 663 V6.7.0 (2006-03)

Foreword

id ,

This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP).

The contents of the present document are subject to continuing work within the TSG and may change following formal
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an
identifying change of release date and an increase in version number as follows:

Version x.y.z

where:

x the first digit:

1 presented to TSG for information;

2 presented to TSG for approval;

3 or greater indicates TSG approved document under change control.

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections,
updates, etc.

z the third digit is incremented when editorial only changes have been incorporated in the document.

Introduction

rd ,

The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification
Group Services and System Aspects; Telecommunication management; as identified below:

32.661: "Configuration Management (CM); Kernel CM; Requirements".

32.662: "Configuration Management (CM); Kernel CM; Information Service (IS)".

32.663: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP):

Common Object Request Broker Architecture (CORBA) Solution Set (SS)".

32.664: "Configuration Management (CM); Kernel CM Integration Reference Point (IRP): Common

Management Information Protocol (CMIP) Solution Set (SS)".

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by
functions in the Operations Systems (OSs) or NEs.

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an
optimisation programme (e.g. modifications), and to maintain the overall Quality of Service (QoS). The CM actions are
initiated either as single actions on single NEs of the 3G network, or as part of a complex procedure involving actions
on many resources/objects in one or several NEs.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 5 ETSI TS 1 32 663 V6.7.0 (2006-03)

Scope

The purpose of the present document is to define the mapping of the Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) to
the protocol specific details necessary for implementation of this IRP in a CORBA/IDL environment.

This Solution Set specification is related to 3GPP TS 32.662 V6.3.X [4].

2 References

The following documents contain provisions which, through reference in this text, constitute provisions of the present
document.

• References are either specific (identified by date of publication, edition number, version number, etc.) or
non-specific.

• For a specific reference, subsequent revisions do not apply.

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same
Release as the present document.

[I] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements".

[2] 3GPP TS 32.102: "Telecommunication management; Architecture".

[3] 3GPP TS 32.600: "Telecommunication management; Configuration Management (CM); Concept

and high-level requirements".

[4] 3GPP TS 32.662: "Telecommunication management; Configuration Management (CM); Kernel

CM: Information Service (IS)".

[5] 3GPP TS 32.300: "Telecommunication management; Configuration Management (CM); Name

convention for Managed Objects".

[6] Object Management Group 98 (November 1998): "Notification Service: Joint Revised Submission

OMG TC Document telecom/98-11-01".

[7] OMG CORBA Services (November 1996): "Common Object Services Specification" (clause 4

contains the Event Service specification).

[8] The Common Object Request Broker: Architecture and Specification (for specification of valid

version, see [1]).

[9] 3GPP TS 32.303: "Telecommunication management; Configuration Management (CM);

Notification Integration Reference Point (IRP): Common Object Request Broker Architecture
(CORBA) Solution Set (SS)".

[10] 3GPP TS 32.1 1 1-3: "Telecommunication management; Fault Management; Part 3: Alarm

Integration Reference Point (IRP): Common Object Request Broker Architecture (CORBA)
Solution Set (SS)".

[II] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP)
management: Information Service (IS)".

[12] 3GPP TS 32.673: "Telecommunication management; Configuration Management (CM); State

Management Integration Reference Point (IRP): Common Object Request Broker Architecture
(CORBA) Solution Set (SS)".

[13] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP)

management: Requirements".

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 6 ETSI TS 1 32 663 V6.7.0 (2006-03)

Definitions and abbreviations

3.1 Definitions

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2],
3GPP TS 32.600 [3] and 3GPP TS 32.662 [4] apply.

IRP document version number string (or "IRPVersion"): see 3GPP TS 32.311 [13].

3.2 Abbreviations

For the purposes of the present document, the following abbreviations apply:

CORBA Common Object Request Broker Architecture

DN Distinguished Name

IDL Interface Definition Language (OMG)

IRP Integration Reference Point

IS Information Service

MO Managed Object

MOC Managed Object Class

NRM Network Resource Model

OMG Object Management Group

SS Solution Set

VSE Vendor Specific Extensions

Void

5 Architectural features

The overall architectural feature of Kernel Configuration Management IRP is specified in 3GPP TS 32.662 [4].
This clause specifies features that are specific to the CORBA SS.

5.1 Notifications

Notifications are sent according to the Notification IRP: CORBA SS (see 3GPP TS 32.303 [9]).
The contents of the Kernel CM IRP notifications are defined in the present document.

5.2 Filter language

The filter language used in the SS is the Extended Trader Constraint Language (see OMG Notification Service [6]).
IRP Agents may throw a FilterComplexityLimit exception when a given filter is too complex.

5.3 Syntax for Distinguished Names and Versions

The format of a Distinguished Name is defined in 3GPP TS 32.300 [5].
The version of this IRP is represented as a string (see also clause 3.1).

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

ETSI TS 132 663 V6.7.0 (2006-03)

Mapping

6.1

Void

6.2 Operation and Notification mapping

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) defines semantics of operation and notification visible across the
Kernel Configuration Management IRP. The following table in this subclause indicates mapping of these operations and
notifications to their equivalents defined in this SS.

Table 6.2.1 : Mapping from IS Notification/Operation to SS equivalents

IS Operation/ notification
(3GPP TS 32.662 [4])

SS Method

Qualifier

getNRMIRPVersion

get nrm irp version

M

not if yOb ject Creation

See Notification IRP: CORBA SS [9]

notif yOb ject Deletion

See Notification IRP: CORBA SS [9]

not if yAttributeValueChange

See Notification IRP: CORBA SS [9]

notif y St ateChange

See Notification IRP: CORBA SS [9]

getlRPVersion

get kernel cm irp versions

M

getOperationProf ile

get kernel cm irp operations profile

get Not if icationProf ile

get kernel cm irp notification profile

notif yCMSynchron izationRe commended

See Notification IRP: CORBA SS [9]

6.3 Operation parameter mapping

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) defines semantics of parameters carried in operations across the
Kernel Configuration Management IRP. The following tables in this subclause indicate the mapping of these
parameters, as per operation, to their equivalents defined in this SS.

Table 6.3.1 : Mapping from IS getNRMIRPVersion parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

versionNumberList

ManagedGenericlRPConstDefs::VersionNumberSet version number list

M

vSEVersionNumberList

ManagedGenericlRPConstDefs::VersionNumberSet
vse version number list

M

status

Exceptions:
GetNRMIRPVersion

M

Table 6.3.2: Mapping from IS getlRPVersion parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

versionNumberList

Return value of type ManagedGenericlRPConstDefs::VersionNumberSet

M

status

exception GetKernelCmlRPVersionsException

M

Table 6.3.3: Mapping from IS getOperationProf ile parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

irpVersion

ManagedGenericlRPConstDefs::VersionNumber kernel cm irp version

M

operationNameProf ile,
operationParameterProf ile

Return value of type ManagedGenericlRPConstDefs::MethodList

M

status

Exceptions:

GetKernelCMIRPOperationsProfileException,
ManagedGenericlRPSystem::OperationNotSupported,
ManagedGenericlRPSystem::lnvalidParameter

M

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

ETSI TS 132 663 V6.7.0 (2006-03)

Table 6.3.4: Mapping from IS getNotif icationProf ile parameters to SS equivalents

IS Operation parameter

SS Method parameter

Qualifier

irpVersion

ManagedGenericlRPConstDefs::VersionNumber kernel cm irp version

M

not if icationNameProf ile,

not if icationParameterProf ile

Return value of type ManagedGenericlRPConstDefs::MethodList

M

status

Exceptions:

GetKernelCMIRPNotificationProfileException,
ManagedGenericlRPSystem::OperationNotSupported,
ManagedGenericlRPSystem::lnvalidParameter

M

6.4 Notification attribute mapping

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) identifies and defines the semantics of attributes for

not if yOb ject Creation, notif yOb ject Deletion, notifyAttributeValueChange,

notif yStateChange and notif yCMSynchronizationRecommended for use for its IRP. The following

table in this subclause shows the mapping of the IS notifications to SS equivalents.

Table 6.4.1 : Mapping from IS notifications to SS equivalents

IS notifications in 3GPP TS 32.662 [4]

SS notifications

Qualifier

Notif yOb ject Creation

push structured event

Notif yOb ject Deletion

push structured event

NotifyAttributeValueChange

push structured event

Notif yStateChange

push structured event

Notif yCMSynchronizationRecommended

push_structured_event

The Kernel CM IRP: IS (see 3GPP TS 32.662 [4]) also qualifies the attributes. The following tables in this subclause
show the mapping of these IS attributes to SS equivalents.

Table 6.4.2: Mapping from IS Notification Header attributes to SS equivalent

IS Attribute of

Notification Header
in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

objectClass, ob jectlnstance

NotificationlRPConstDefs::AttributeNameValue::
MANAGED OBJECT INSTANCE

M

notificationld

NotificationlRPConstDefs::AttributeNameValue::
NOTIFICATION ID

M

eventTime

NotificationlRPConstDefs::AttributeNameValue::
EVENT TIME

M

systemDN

NotificationlRPConstDefs::AttributeNameValue::
SYSTEM DN

notif icationType

--

M

Table 6.4.3: Mapping from IS notifyOb jectcreation attributes
to SS equivalent OBJECT_CREATION

IS Attribute of

notif yOb jectCreation
in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

notificationHeader

See table 6.4.2

M

correlatedNotif i cat ions

KernelCmNotifications::MOCreation::CORRELATED_NOTIFICATIONS

additional Text

KernelCmNotifications::MOCreation::ADDITIONAL_TEXT

sourcelndicator

KernelCmNotifications::MOCreation::SOURCE_INDICATOR

attributeList

KernelCmNotifications::MOCreation::lnitialAttributeValues (contained in
remainder_of_body)

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

ETSI TS 132 663 V6.7.0 (2006-03)

Table 6.4.4: Mapping from IS notifyOb jectDeletion attributes
to SS equivalent OBJECT_DELETION

IS Attribute of

not if yOb jectDeletion
in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

notificationHeader

See table 6.4.2

M

correlatedNotif i cat ions

KernelCmNotifications::MODeletion::CORRELATED_NOTIFICATIONS

additional Text

KernelCmNotifications::MODeletion::ADDITIONAL_TEXT

source Indicator

KernelCmNotifications::MODeletion::SOURCE_INDICATOR

at tribute Li st

KernelCmNotifications::MODeletion::Attribute Values (contained in
remainder_of_body)

Table 6.4.5: Mapping from IS notifyAttributeValueChange attributes
to SS equivalent ATTRIBUTE_VALUE_CHANGE

IS Attribute of

notifyAttributeValue

Change

in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

notificationHeader

See table 6.4.2

M

correlatedNotif icat ions

KernelCmNotifications::AttributeValueChange::CORRELATED_NOTIFICATIONS

additionalText

KernelCmNotifications::AttributeValueChange::ADDITIONAL_TEXT

source Indicator

KernelCmNotifications::AttributeValueChange::SOURCE_INDICATOR

at tribute ValueChangeDef inition

KernelCmNotifications::AttributeValueChange::ModifiedAttributeSet (contained in
remainder_of_body)

M

Table 6.4.6: Mapping from IS notifyCMSynchronizationRecommended attributes
to SS equivalent REQUEST_CM_SYNCHRONIZATION

IS Attribute of

notifyCMSynchronization

Recommended

in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

notificationHeader

See table 6.4.2

M

baseMOClass

KernelCmNotifications::CMSynchronizationRecommended::BASE MO CLASS

M

baseMOIn stance

KernelCmNotifications::CMSynchronizationRecommended::BASE MO INSTANCE

M

scope

KernelCmNotifications::CMSynchronizationRecommended::SCOPE

M

additionalText

KernelCmNotifications::CMSynchronizationRecommended::ADDITIONAL_TEXT

Table 6.4.7: Mapping from IS notifyStateChange attributes
to SS equivalent STATE_CHANGE

IS Attribute of

notifyStateChange

Change
in 3GPP TS 32.662 [4]

SS Attribute

Qualifier

notificationHeader

See table 6.4.2

M

stateChange

StateManagementlRPConstDefs::AttributeNameValue (see note)

M

correlatedNotif icat ions

KernelCmNotifications::StateChange::CORRELATED NOTIFICATIONS

additionalText

KernelCmNotifications::StateChange::ADDITIONAL TEXT

source Indicator

KernelCmNotifications::StateChange::SOURCE INDICATOR

NOTE: The stateChange attribute is mapped into name-value pairs that contain the state identifier in the name and
the new and optional old state values in the attribute field (See TS 32.673 [1 2]
StateManagementlRPConstDefs IDL <State Name>OldNewValue structures).

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 1 ETSI TS 1 32 663 V6.7.0 (2006-03)

7 Use of OMG Structured Event

In CORBA SS, OMG defined StructuredEvent (see OMG Notification Service [6]) is used to carry notifications.
This clause identifies the OMG defined StructuredEvent attributes that carry the attributes of notifications defined
in3GPPTS32.662[4].

The composition of OMG Structured Event, as defined in OMG Notification Service [6], is:

Header

Fixed Header

doma i n_n ame
typejame
event_name
Variable Header
Body

filter able_body_f ields
remainder_of_body

The following table in this clause lists all OMG Structured Event attributes in its leftmost column. The second column
identifies the SS attributes, if any, that shall be carried there.

Attributes that are denoted as "optional" may be absent from the OMG Structured Event. As an example, if the optional
additionalText attribute is not used for a particular notification, then the IRP Agent may exclude
additionalText from the filterable body fields for that particular notification. Individual notifications from the
same IRP Agent may include or exclude the same optional attribute.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

11

ETSI TS 132 663 V6.7.0 (2006-03)

Table 7.1 : Use of OMG Structured Event

IS Parameters

OMG CORBA

Structured
Event attribute

Comment

There is no
corresponding IS
parameter.

domain_name

It contains the supported SS document version (see clause 4). This version is
defined by the string constant KernelCmlRPSystem::VERSION defined in this
specification.

notification
Type

type_name

It is an attribute of notificationHeader. It shall indicate one of the following: Object
Creation, Object Deletion, Attribute Value Change, State Change and CM
Synchronization Recommended. It is a string. Its value is either defined by
KernelCmNotifications::MOCreation::EVENT_TYPE,
KernelCmNotifications::MODeletion::EVENT TYPE,
KernelCmNotifications::AttributeValueChange::EVENT TYPE,
KernelCmNotifications::StateChange::EVENT_TYPEor
KernelCmNotifications::CMSynchronizationRecommended::EVENT_TYPE

There is no
corresponding IS
parameter.

event_name

It shall be set to an empty string.

There is no
corresponding IS
parameter.

variable Header

ob jectClass,
ob jectlnstan
ce

One NV pair of

filterable_body_fi

elds

NV stands for name-value pair. Order arrangement of NV pairs is not significant.
The name of NV-pair is always encoded in string.

Name of this NV pair is the MANAGED_OBJECT_INSTANCE of interface
AttributeNameValue of module NotificationlRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA
SS (3GPP TS 32.303 [9]).

notification
Id

One NV pair of
remainder of bo
dy

Name of NV pair is the NOTIFICATIONJD of interface AttributeNameValue of
module NotificationlRPConstDefs.

Value of NV pair is a long. See corresponding table in Notification IRP: CORBA
SS (3GPP TS 32.303 [9]).

eventTime

One NV pair of

filterable_body_fi

elds

Name of NV pair is the EVENT_TIME of interface AttributeNameValue of module
NotificationlRPConstDefs.

Value of NV pair is IRPTime. See corresponding table in Notification IRP: CORBA
SS(3GPPTS 32.303 [9]).

systemDN

One NV pair of

filterable_body_fi

elds

Name of NV pair is the SYSTEM_DN of interface AttributeNameValue of module
NotificationlRPConstDefs.

Value of NV pair is a string. See corresponding table in Notification IRP: CORBA
SS [9].

correlatedNo
tif ications

One NV pair of
remainder of bo
dy

It is an attribute of the Object Creation, Object Deletion and Attribute Value
Change notifications.

Name of NV pair is the
KernelCmNotifications::NotificationCommon::CORRELATED_NOTIFICATIONS.

Value of NV pair is a NotificationlRPConstDefs::CorrelatedNotificationSet defined
in 3GPP TS 32.303 [9].

additionalTe
xt

One NV pair of
remainder of bo
dy

It is an attribute of the Object Creation, Object Deletion, Attribute Value Change
and CM Synchronization Recommended notifications.

Name of NV pair is the
KernelCmNotifications::NotificationCommon::ADDITIONAL_TEXT

Value of NV pair is a string.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

12

ETSI TS 132 663 V6.7.0 (2006-03)

sourcelndica
tor

One NV pair of
remainder of bo
dy

It is an attribute of the Object Creation, Object Deletion and Attribute Value
Change notifications.

Name of NV pair is the
KernelCmConstDefs::AttributeNameValue::SOURCE_INDICATOR.

Value of NV pair is the

KernelCrnNotifications::NotificationCommon::RESOURCE OPERATION or
MANAGEMENT_OPERATION or UNKNOWNJDPERATION.

attributeLis
t

remainder_of_no

n_filterable_body

(see

3GPP TS 32.303

[9])

It is used to transport attribute information.

For Object Creation notification, this is defined by
KernelCmNotifications::MOCreation::lnitialAttributeValues.
For Object Deletion notification, this is defined by
KernelCmNotifications::MODeletion::Attribute Values.

The name component of InitialAttributeValues and AttributeValues will be set to
attribute names defined in KernelCmNRMDefs.

attributeVal
ueChangeDef i
nition

remainder_of_no

n_filterable_body

(see

3GPP TS 32.303

[9])

For Attribute Value Change notification, this is defined by
KernelCmNotifications::AttributeValueChange::ModifiedAttributeSet.

The name component of ModifiedAttributeSet will be set to attribute name defined
in KernelCmNRMDefs.

StateManagem
entlRPConstD
ef s : : Attribu
teNameValue

A set of up to 9
Name-value pairs
See table 7.2. All
these 9 NV pairs
are part of the
remainder of bo
dy

For state change notifications a series of up to 9 name-value pairs might be sent
corresponding with the new and old values of each state/status attribute which has
changed it's value.

The new values of each state/status attributes that have changed are sent.

The IRP agent may optionally send the old state/status changes.
The name of the name-value pairs are defined by
StateManagementlRPConstDefs::AttributeNameValue

baseMOClass

One NV pair of
remainder of bo
dy

It is an attribute of the CMSynchronizationRecommended notification.
Name of NV pair is a string,

KernelCmNotifications::CMSynchronizationRecommended::BASE_MO_CLASS.

Value of NV pair is a string. This string conveys the semantics of the Managed
Object Class.

baseMOInstan
ce

One NV pair of
remainder of bo
dy

It is an attribute of the CMSynchronizationRecommended notification.
Name of NV pair is the
KernelCmNotifications::CMSynchronizationRecommended::BASE MO INSTANC

E.

Value of NV pair is a string. This is the DN string of the Managed Object Instance.

scope

One NV pair of
remainder of bo
dy

It is an attribute of the CMSynchronizationRecommended notification.
Name of NV pair is the
KernelCmNotifications::CMSynchronizationRecommended::SCOPE.

Value of NV pair is KernelCmConstDefs::ScopePara.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

13

ETSI TS 132 663 V6.7.0 (2006-03)

Table 7.2 Name - value pairs for state change notifications

Name

Value

OPERATIONAL STATE

StateManagementlRPConstDefs::OperationalStateOldNewValue

USAGE STATE

StateManagementlRPConstDefs::UsageStateOldNewValue

ADMINISTRATIVE STATE

StateManagementlRPConstDefs::AdministrativeStateOldNewValue

ALARM STATUS

StateManagementlRPConstDefs::AlarmStatusOldNewValue

PROCEDURAL STATUS

StateManagementlRPConstDefs::ProceduralStatusOldNewValue

AVAILABILITY STATUS

StateManagementlRPConstDefs::AvailabilityStatusOldNewValue

CONTROL STATUS

StateManagementlRPConstDefs::ControlStatusOldNewValue

STANDBY STATUS

StateManagementlRPConstDefs::StandbyStatusOldNewValue

UNKNOWN STATUS

StateManagementlRPConstDefs::UnknownStatusOldNewValue

8

Rules for NRM extensions

This clause discusses how the models and IDL definitions provided in the present document can be extended for a
particular implementation and still remain compliant with 3GPP SA5's specifications.

8.1

Void

8.2

Extensions not allowed

The IDL specifications in the present document cannot be edited or altered. Any additional IDL specifications shall be
specified in separate IDL files.

IDL interfaces (note: not MOCs) specified in the present document may not be subclassed or extended. New interfaces
may be defined with vendor-specific methods.

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 1 4 ETSI TS 1 32 663 V6.7.0 (2006-03)

Annex A (normative):

IDL specification (file name "KernelCmConstDefs.idl")

//File: KernelCmConstDefs.idl
#ifndef _KERNEL_CM_CONST_DEFS_IDL_
#define _KERNEL_CM_CONST_DEFS_IDL_

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

module KernelCmConstDef s

{

/**

* Information about one attribute

* - name defines the name of the attribute

* - value defines the value of the attribute

*/

struct MOAttribute
{

string name;

any value;

};

/**

* A set of attribute names and values
*/

typedef sequence<MOAttribute> MOAttributeSet ;

/**

* ScopeType defines the kind of scope to use in a CM synchronization

* request together with ScopePara. level, in the SCOPE field.

* ScopePara . level is always >= 0. If a level is bigger than the

* depth of the tree there will be no exceptions thrown.

* BASE_ONLY : level ignored, just return the base object.

* BASE_NTH_LEVEL: return all subordinate objects that are on "level"

* distance from the base object, where is the base object.

* BASE_SUBTREE : return the base object and all of its subordinates

* down to and including the nth level.

* BASE_ALL : level ignored, return the base object and all of it's

* subordinates.
*/

enum ScopeType
{

BASE_0NLY,

BASE_NTH_LEVEL,

BASE_SUBTREE,

BASE_ALL

};

struct ScopePara
{

ScopeType type;

unsigned long level;
};

/* The format of Distinguished Name (DN) is specified in 3GPP TS 32.300

"Name Conventions for Managed Objects".

*/

typedef string DN;

typedef sequence <long> NotifldSet;

/*

This holds identifiers of notifications that are correlated.

*/

struct CorrelatedNotif ication

{

DN source; // Contains DN of MO that emitted the set of notifications

// DN string format in compliance with Name Convention for

// Managed Object.

// This may be a zero-length string. In this case, the MO

// is identified by the value of the MOI attribute

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 15 ETSI TS 1 32 663 V6.7.0 (2006-03)

// of the Structured Event, i.e., the notification.
NotifldSet notif_id_set; // Set of related notification ids
};

/*

Correlated Notification sets are sets of Correlated Notification

structures .

*/

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSet;

/*

This block identifies attributes which are included as part of the Kernel

CM IRP . These attribute values should not clash with those defined for the

attributes of notification header (see IDL of Notification IRP) .

*/

interface AttributeNameValue

{

const string SOURCE_INDICATOR = "SOURCE";

const string ADDITIONAL_TEXT = "ADD_TEXT";

const string CORRELATED_NOTIFICATIONS = "CORREL_NOTIFS" ;

const string BASE_MO_CLASS = "BASE_MOC";

const string BASE_MO_INSTANCE = "BASE_MOI";

const string SCOPE = "SCOPE";

};
};

#endif // _KERNEL_CM_CONST_DEFS_IDL_

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 16 ETSI TS 1 32 663 V6.7.0 (2006-03)

Annex B (normative):

IDL specification (file name "KernelCmlRPSystem.icH")

//File: KernelCmlRPSystem. idl
#ifndef _KERNEL_CM_IRP_SYSTEM_IDL_
#define _KERNEL_CM_IRP_SYSTEM_IDL_

#include <ManagedGenericIRPConstDef s . idl>
#include <ManagedGenericIRPSystem. idl>

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

module KernelCmlRPSystem

{

exception GetKernelCMIRPNotif icationProf ileException { string reason; };
exception GetKernelCMIRPOperationsProf ileException { string reason; };
exception GetNRMIRPVersion { string reason; };
exception GetKernelCMIRPVersionsException { string reason; };

/**

* The KernelCmlrpOperations interface.

* Supports a number of Resource Model versions.
*/

interface KernelCmlrpOperations
{

/*

Return the list of all supported Kernel CM IRP versions.

*/

ManagedGenericIRPConstDef s : : VersionNumberSet get_kernel_cm_irp_versions (

)

raises (GetKernelCMIRPVersionsException) ;

/**

* Get the version (s) of the interface

* @raises GetNRMIRPVersion when the system for some reason

* can not return the supported versions.

* ^returns all supported versions.
*/

void get_nrm_irp_version

(

out ManagedGenericIRPConstDef s : : VersionNumberSet version_number_list,
out ManagedGenericIRPConstDef s : : VersionNumberSet vse_version_number_list

)

raises (GetNRMIRPVersion) ;

/*

Return the list of all supported operations and their supported

parameters for a specific KernelCM IRP version.

*/

ManagedGenericIRPConstDef s : :MethodList get_kernel_cm_irp_operations„prof ile (

in ManagedGenericIRPConstDef s : : VersionNumber kernel„cm_irp_version
)
raises (GetKernelCMIRPOperationsProf ileException,

ManagedGenericIRPSystem: : OperationNotSupported,

ManagedGenericIRPSystem: : InvalidParameter) ;

/*

Return the list of all supported notifications and their supported

parameters for a specific KernelCM IRP version.

*/

ManagedGenericIRPConstDef s : :MethodList

get_kernel_cm_irp_notif ication_prof ile
(

in ManagedGenericIRPConstDef s : : VersionNumber kernel_cm_irp_version
)
raises (GetKernelCMIRPNotif icationProf ileException,

ManagedGenericIRPSystem: : OperationNotSupported,
ManagedGenericIRPSystem: : InvalidParameter) ;

#endif // _KERNEL_CM_IRP_SYSTEM_IDL_

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 1 7 ETSI TS 1 32 663 V6.7.0 (2006-03)

Annex C (normative):

IDL specification (file name "KernelCmNotifications.idl")

//File : KernelCmNotif ications . idl
#ifndef _KERNEL_CM_NOTIFICATIONS_IDL_
#define _KERNEL„CM_NOTIFICATIONS_IDL_

#include <KernelCmConstDef s . idl>

#include <Notif icationlRPNotif ications . idl>

// This statement must appear after all include statements
#pragma prefix "3gppsa5.org"

module KernelCmNotif ications
{

/**

* This interface defines fields that are common for all

* notification types.

* All constants in the scope of this interface will be

* visible in the interfaces that inherits this.

* For instance constant

* NotificationCommon: :MANAGED_OBJECT_CLASS

* can be addressed by MODeletion: :MANAGED_OBJECT_CLASS
*/

interface NotificationCommon: Notif icationlRPNotif ications : :Notify
{

/**

* This constant defines the name of the

* source indicator property.
*/

const string SOURCE_INDICATOR =

KernelCmConstDefs: : AttributeNameValue : : SOURCE_INDICATOR;

/**

* Valid values for the S0URCE_INDICAT0R

* property
*/

const string RESOURCE_OPERATION = "RESOURCE OPERATION";
const string MANAGEMENT_OPERATION = "MANAGEMENT OPERATION";
const string UNKNOWN_OPERATION = "UNKNOWN";

/**

* This constant defines the name of the

* additional text property.

* The data type for the value of this property

* is a string.
*/

const string ADDITIONAL_TEXT =

KernelCmConstDefs: : AttributeNameValue : : ADDITIONAL_TEXT;

/**

* This constant defines the name of the

* correlated notifications property.

* The value part of the property is

* KernelCmConstDefs: : CorrelatedNotif icationSet
*/

const string CORRELATED_NOTIFICATIONS =

KernelCmConstDefs: : AttributeNameValue : : CORRELATED_NOTIFICATIONS;

};

/**

* Constant definitions for the MO deleted notification
*/

interface MODeletion : NotificationCommon
{

const string EVENT_TYPE = "x7";

/**

* This information mapped into the remainder_of_body

* in the StructuredEvent
*/

typedef KernelCmConstDef s : :MOAttributeSet AttributeValues;

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 1 8 ETSI TS 1 32 663 V6.7.0 (2006-03)

/**

* Constant definitions for the MO created notification
*/
interface MOCreation : Notif icationCommon

{

const string EVENT_TYPE = "x6";

/**

* This information mapped into the remainder_of„body

* in the StructuredEvent
*/

typedef KernelCmConstDef s : :MOAttributeSet InitialAttributeValues;

/**

* Constant definitions for the Attribute Value Change

* notification
*/

interface AttributeValueChange : Notif icationCommon
{

const string EVENT_TYPE = "x8";

/**

* Information about modified attributes for

* one MO instance.

* - name defines the name of the attribute

* - new_value defines the new value of the attribute

* - old_value defines the previous value of the attribute

* The value is optional, which means that it may contain

* an empty any (null inserted in the any) .

*/
struct Modif iedAttribute
{

string name;

any new_value;

any old__value;

/**

* This information mapped into the remainder_of_body

* in the StructuredEvent.
*/

typedef sequence<Modif iedAttribute> Modif iedAttributeSet;

/**

* Constant definitions for the CM Synchronization Recommended notification

*/
interface CMSynchronizationRecommended: Notif icationlRPNotif ications : : Notify
{

const string EVENT_TYPE = "x9";

/**

* This constant defines the name of the

* additional text property.

* The data type for the value of this property

* is a string.
*/

const string ADDITIONAL_TEXT =

KernelCmConstDef s: : AttributeNameValue : : ADDITIONAL_TEXT;

* This constant defines the name of the

* base MO class property.

* The value part of this property will carry

* the base MO class name as a string.
*/

const string BASE_MO_CLASS =

KernelCmConstDef s: : AttributeNameValue : : BASE_MO_CLASS;

/**

* This constant defines the name of the

* base MO instance property.

* The value part of this property will carry

* the base MO distinguished name as a string.
*/

const string BASE_MO_INSTANCE =

ETSI

3GPP TS 32.663 version 6.7.0 Release 6 19 ETSI TS 1 32 663 V6.7.0 (2006-03)

KernelCmConstDefs: : AttributeNameValue : : BASE_MO_INSTANCE;

/**

* This constant defines the name of the

* scope property.

* The data type for the value of this property

* is KernelCmConstDef s : : ScopePara .
*/

const string SCOPE =

KernelCmConstDefs: : AttributeNameValue : : SCOPE;

};

/**

* Constant definitions for the State Change notification
*/
interface StateChange : Notif icationCommon

{

const string EVENT_TYPE = "xA";

};
};

#endif // _KERNEL_CM_NOTIFICATIONS_IDL_

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

20

ETSI TS 132 663 V6.7.0 (2006-03)

Annex D (informative):
Change history

Change history

Date

TSG#

TSG Doc.

CR

Rev

Subject/Comment

Cat

Old

New

Sep 2002

SA 17

SP-020466

--

--

Submitted to TSG SA #17 for Approval

-

1.0.0

5.0.0

Mar 2003

SA 19

SP-030143

0001

--

CORBA IDL Compiler Errors

F

5.0.0

5.1.0

Mar 2003

SA_19

SP-030145

0002

—

Add IDL definition of notifyCMSynchronizationRecommended notification
for KernelCM IRP

B

5.1.0

6.0.0

Jun 2004

SA 24

SP-040261

0004

--

Add Missing CorrelatedNotificationSetType definition

A

6.0.0

6.1.0

Sep 2004

SA 25

SP-040568

0007

--

Add missing DN definition

A

6.1.0

6.2.0

Sep 2004

SA 25

SP-040568

0009

--

Add missing IDL for get kernel CM IRP versions

A

6.1.0

6.2.0

Sep 2004

SA 25

SP-040569

0010

--

Add State Management Support to Kernel CM IRP CORBA SS

B

6.1.0

6.2.0

Dec 2004

SA_26

SP-040812

0011

—

Correct the mapping of IS-defined non-filterable parameters to SS-defined
non-filterable fields (instead of filterable fields) - Align with IS in 32.662

F

6.2.0

6.3.0

Mar 2005

SA_27

SP-050050

0012

--

IDL incompliant to the style guide

F

6.3.0

6.4.0

Jun 2005

SA_28

SP-050299

0013

-

Correct CORBA SS mapping of notification filterable/non-filterable IS
parameters

F

6.4.0

6.5.0

Sep 2005

SA 29

SP-050461

0014

--

Align the CORBA SS IDL with TS 32.1 50 Style Guide

F

6.5.0

6.6.0

Mar 2006

SA 31

SP-060089

0015

--

Correct case sensitive parameter name

F

6.6.0

6.7.0

ETSI

3GPP TS 32.663 version 6.7.0 Release 6

21

ETSI TS 132 663 V6.7.0 (2006-03)

History

Document history

V6.3.0

December 2004

Publication

V6.4.0

March 2005

Publication

V6.5.0

June 2005

Publication

V6.6.0

September 2005

Publication

V6.7.0

March 2006

Publication

ETSI